Exporting Dataspace Project Artifacts Using ALDSP Export Wizards

This section describes the various types of export operations available for ALDSP dataspace projects.

Topics

Exporting Dataspace Artifacts
Generating a Data Service Definitions and Artifacts JAR
Generating a Mediator Client JAR File
Generating a JAR File Containing Data Service-to-Web Service Maps

Exporting Dataspace Artifacts

The ALDSP export wizards can be accessed using the File > Export menu, then expand on the ALDSP export wizard category.

File > Export... > AquaLogic Data Services Platform

Artifacts can only be exported from deployable dataspace projects; if your project is not deployable, the export operation will not succeed.

Exporting a Dataspace Project

In the ALDSP category there are three wizards. Each generates a specific type of JAR file.

Types of ALDSP JAR File Export Operations

Export Type	Effect
Data service definitions and artifacts	All ALDSP deployable artifacts are bundled into a JAR file.
Mediator client	A Java interface for accessing data services is created.
Web services mediator client	A web services interface for accessing data services is created.

Any dataspace projects pre-selected in the Project Explorer will automatically be selected in the export wizard.

Generating a Data Service Definitions and Artifacts JAR

An exported JAR file containing a single project's server-deployable definitions and artifacts. Such a file can be imported into another ALDSP-enabled version of Eclipse. In addition, the definitions and artifacts JAR can be useful:

As a means of transporting a dataspace from one application to another.
In conjunction with certain refactoring operations.
For deployment on multiple servers (clusters) at a later time.
For debugging purposes.

Export Data Service Definitions and Artifacts

In the wizard, the contents you identify using their adjacent checkbox will be exported. For example if you check the box next to the project name, all of that projects server-deployable components will be selected.

You can fine-tune your selection by clicking on a folder. The folder's contents will appear in the right-hand column where you can use a checkbox to control which artifact will be exported.

Actions Associated with Generating a Data Service Definitions and Artifacts JAR

Item	Recommended Setting or Action	Details - Comments
Export Data Service Definitions and Artifacts Page
Check folders or their contents that you want to export
Deselect All		Convenience if more than one project is selected.
To Directory:	/user_projects/helloworld	JAR file can be exported anywhere on the system.
Filename:	-artifacts.jar	Example: mySpace-dsp-client.jar
Use default filename option	Selected	When selected editing of the generated filename is not allowed.
Overwrite existing file without warning option	Unselected	If unselected you will be asked if you want to overwrite any existing file of the same name.
Success message	Finish	Identifies project and target name.

Generating a Mediator Client JAR File

This wizard presents a list of open ALDSP projects to select from, and it generates an ALDSP mediator client JAR file from the currently selected project. Projects are exported one at a time.

Java programs access data services through the ALDSP Mediator API. This API is generated from the ALDSP Eclipse platform and is based on a project that can be successfully built and deployed.

Accessing Data Services from Java Clients

Export Mediator Client JAR Wizard

Steps Associated with Generating a Mediator Client API JAR File

Item	Recommended Setting or Action	Details - Comments
Select the Mediator Client JAR File export wizard
Type:	Mediator Client JAR File
Select a Dataspace Project Page	Next
Pick a dataspace project	mySpace	Only one project at a time can be exported.
Deselect All		Convenience if more than one project is selected.
To Directory:	/user_projects/helloworld	JAR file can be exported anywhere on the system.
Filename:	-dsp-client.jar	Example: mySpace-dsp-client.jar
Use default filename option	Selected	When selected editing of the generated filename is not allowed.
Overwrite existing file without warning option	Unselected	If unselected you will be asked if you want to overwrite any existing file of the same name.
Success message	Finish	Identifies project and target name.

Generating a JAR File Containing Data Service-to-Web Service Maps

After you have created a web service map of one or more data services you can create an exported JAR file containing these maps.

Then the created JAR file can be used as your applications web service interface to available data services.

Only publicly available operations can be turned into web service operations. You can adjust access level to a data service function through the Properties window.

Exporting a Web Services Mediator Client JAR File

Actions Associated with Generating a Web Services Mediator Client JAR File

Item	Recommended Setting or Action	Details - Comments
Export Web Services Mediator Client JAR File
Check folders or their contents that contain web service maps	Select folder	Click on the exportable dataspace folder to located selected WS file.
Deselect All		Convenience if more than one project is selected.
To Directory:	/user_projects/helloworld	JAR file can be exported anywhere on the system.
Filename:	-ws-client.jar	Example: mySpace-ws-client.jar
Use default filename option	Selected	When selected editing of the generated filename is not allowed.
Overwrite existing file without warning option	Unselected	If unselected you will be asked if you want to overwrite any existing file of the same name.
Success message	Finish	Identifies project and target name.

Document generated by Confluence on Jan 15, 2008 11:02